package com.cencat.user.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.cencat.common.exception.BusinessException;
import com.cencat.common.response.PageResponse;
import com.cencat.user.dto.RoleCreateDTO;
import com.cencat.user.dto.RoleUpdateDTO;
import com.cencat.user.dto.RoleQueryDTO;
import com.cencat.user.entity.Role;
import com.cencat.user.vo.RoleVO;
import com.cencat.user.vo.RoleListVO;

import java.util.List;

/**
 * 角色服务接口
 * @author cencat
 * @since 2024-01-01
 */
public interface RoleService {

    /**
     * 创建角色
     * @param dto 角色创建DTO
     * @return 角色ID
     * @throws BusinessException 业务异常
     */
    Long createRole(RoleCreateDTO dto) throws BusinessException;

    /**
     * 更新角色
     * @param dto 角色更新DTO
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean updateRole(RoleUpdateDTO dto) throws BusinessException;

    /**
     * 删除角色（逻辑删除）
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean deleteRole(Long roleId, Long tenantId) throws BusinessException;

    /**
     * 批量删除角色（逻辑删除）
     * @param roleIds 角色ID列表
     * @param tenantId 租户ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean batchDeleteRoles(List<Long> roleIds, Long tenantId) throws BusinessException;

    /**
     * 根据ID查询角色详情
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @return 角色详情
     * @throws BusinessException 业务异常
     */
    RoleVO getRoleById(Long roleId, Long tenantId) throws BusinessException;

    /**
     * 根据角色编码查询角色
     * @param roleCode 角色编码
     * @param tenantId 租户ID
     * @return 角色信息
     * @throws BusinessException 业务异常
     */
    Role getRoleByCode(String roleCode, Long tenantId) throws BusinessException;

    /**
     * 根据角色名称查询角色
     * @param roleName 角色名称
     * @param tenantId 租户ID
     * @return 角色信息
     * @throws BusinessException 业务异常
     */
    Role getRoleByName(String roleName, Long tenantId) throws BusinessException;

    /**
     * 分页查询角色列表
     * @param queryDTO 查询条件
     * @return 角色分页列表
     * @throws BusinessException 业务异常
     */
    PageResponse<RoleListVO> getRolePage(RoleQueryDTO queryDTO) throws BusinessException;

    /**
     * 查询角色列表
     * @param queryDTO 查询条件
     * @return 角色列表
     * @throws BusinessException 业务异常
     */
    List<RoleListVO> getRoleList(RoleQueryDTO queryDTO) throws BusinessException;

    /**
     * 启用角色
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean enableRole(Long roleId, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 禁用角色
     * @param roleId 角色ID
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean disableRole(Long roleId, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 批量更新角色状态
     * @param roleIds 角色ID列表
     * @param status 角色状态
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean batchUpdateRoleStatus(List<Long> roleIds, Integer status, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 根据用户ID查询角色列表
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 角色列表
     * @throws BusinessException 业务异常
     */
    List<Role> getRolesByUserId(Long userId, Long tenantId) throws BusinessException;

    /**
     * 根据租户ID查询角色列表
     * @param tenantId 租户ID
     * @return 角色列表
     * @throws BusinessException 业务异常
     */
    List<Role> getRolesByTenantId(Long tenantId) throws BusinessException;

    /**
     * 统计角色数量
     * @param queryDTO 查询条件
     * @return 角色数量
     * @throws BusinessException 业务异常
     */
    Long countRoles(RoleQueryDTO queryDTO) throws BusinessException;

    /**
     * 检查角色编码是否存在
     * @param roleCode 角色编码
     * @param excludeRoleId 排除的角色ID
     * @param tenantId 租户ID
     * @return 是否存在
     * @throws BusinessException 业务异常
     */
    Boolean checkRoleCodeExists(String roleCode, Long excludeRoleId, Long tenantId) throws BusinessException;

    /**
     * 检查角色名称是否存在
     * @param roleName 角色名称
     * @param excludeRoleId 排除的角色ID
     * @param tenantId 租户ID
     * @return 是否存在
     * @throws BusinessException 业务异常
     */
    Boolean checkRoleNameExists(String roleName, Long excludeRoleId, Long tenantId) throws BusinessException;

    /**
     * 为用户分配角色
     * @param userId 用户ID
     * @param roleIds 角色ID列表
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean assignRolesToUser(Long userId, List<Long> roleIds, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 移除用户角色
     * @param userId 用户ID
     * @param roleIds 角色ID列表
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean removeRolesFromUser(Long userId, List<Long> roleIds, Long tenantId, Long operatorId) throws BusinessException;
}